home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1 Issue 2 / PDCD-1 - Issue 02.iso / _utilities / utilities / 004 / _config_ / !Config+ / !Help < prev    next >
Text File  |  1994-09-23  |  18KB  |  336 lines

  1. Con₧gure+ version 1.00
  2. ⌐ Sam Kington 24th September 1994
  3.  
  4. This program is freeware, *not* public domain ù i.e., I retain copyright on
  5. Con₧gure+ and all the related ₧les (see öBoring legal messageò). !Con₧gure
  6. and the patched Con₧gure ₧les remain ⌐ Acorn Computers Ltd. and must not be
  7. copied.
  8.  
  9. If youære not going to read all of this ₧le, at least read section öHow to
  10. get this to workò ù otherwise it wonæt work (obvious really...).
  11.  
  12. What this program does
  13. **********************
  14.  
  15.    This program is an extension to !Con₧gure: it allows you to set various
  16. con₧gure options that !Con₧gure omitted, while apparently still using
  17. !Con₧gure. It adds four icons to Con₧gureæs main window, öDrivesò, öFilerò,
  18. öMiscò and öThird partyò; clicking on any of these brings up a window,
  19. exactly like clicking on any of the other icons. The ₧rst three new windows
  20. behave exactly like the others do, apart from the fact that they are in fact
  21. öownedò by Con₧gure+ rather than Con₧gure, and that the öMiscò window has a
  22. scroll bar because thereæs so much in it. The öThird partyò window is
  23. slightly different, as it contains all the *Con₧gure options the program
  24. didnæt know about, and is thus slightly less nice (see below for more
  25. details).
  26.  
  27.    As this is an extension to Con₧gure, operation should be self-explanatory:
  28. if you know how to use Con₧gure, you should know how to use Con₧gure+. If you
  29. want to know what all these new con₧guration options are, use interactive
  30. help and everything will become clear (hopefully).
  31.  
  32. Why do I need this?
  33. *******************
  34.  
  35.    Because, when Acorn wrote Con₧gure, they left a few things out. The
  36. Con₧gure options in the extra window range from quite useful (ARM3 Cache) to
  37. frankly esoteric (Scroll or More dither patterns), and some can be set elsewhere
  38. (₧ler and net₧ler options, Boot in the Desktop Save box from the Task Manager
  39. iconbar menu) ù you wonæt want to use them all the time, and indeed you
  40. probably wonæt want to use them as much as you will the other options. But
  41. itæs a more friendly way of setting them, it avoids shelling out to the CLI
  42. (F12 or Ctrl-F12), especially as some cannot be set from the command line.
  43.  
  44.    Many of the options in the Misc window are either undocumented or tricky
  45. to set (i.e. there isnæt a *Con₧gure option for them). This is the case of
  46. full hardware tests, solid drags, screen update stops blanker, 3D desktop and
  47. especially prompt for ƒoppy on reset. This last one is in fact totally
  48. undocumented, and I am grateful to Christopher Swaley (BAU July 1993) for
  49. pointing this one out to me. (I had actually found it myself by accident, but
  50. I didnæt know where in CMOS RAM it was). (Conversely, some documented
  51. options donæt actually work, even though theyære in the PRMs...). Again, none
  52. of this is earth-shattering stuff, except solid drags, although if you have
  53. Desktop+ (and you should have) solid drags will be turned on automatically.
  54.  
  55.    Another reason for using Con₧gure+ is that while Con₧gure will save the
  56. entire contents of the CMOS RAM to a Con₧gure ₧le, it will only load back
  57. into CMOS RAM (from a Con₧gure ₧le), the options it knows about. This means
  58. it doesnæt load ADFSBuffers, Cache, third party con₧guration options, etc.
  59. etc. Con₧gure+ will notice when you load a new Con₧gure ₧le, and load all the
  60. options properly. This does mean, of course, that it will take quite a long
  61. time (1 or 2 seconds ù accessing CMOS RAM is quite slow), but then you
  62. shouldnæt have to do this sort of thing too often.
  63.    RISC OS 3.5 !Con₧gure no longer loads Con₧gure ₧les - instead you have to
  64. use SaveCMOS. I couldnæt be bothered to change it, and anyway I think you
  65. *should* be able to load Con₧gure ₧les by dragging them to Con₧gure, so for
  66. RISC PC users Con₧gure+ adds even more functionality ;).
  67.  
  68.    A ₧nal reason is that Con₧gure+ knows about third-party modulesæ
  69. con₧guration options, or, to be more accurate, only pretends it does but does
  70. it quite convincingly. The öThird partyò window contains a list of all the
  71. con₧guration options provided by non-Acorn modules, either in expansion cards
  72. or in RAM, that you can set by ₧lling in the appropriate results. There are
  73. no fancy arrows or menu boxes or anything because Con₧gure+ doesnæt know
  74. about the new options, but you do get the *Help text and syntax messages if
  75. you use interactive help on the windows (*Help message for the name of the
  76. option, at the left of the window, syntax message for the value of the
  77. option, at the right of the window).
  78.  
  79.    NB: Con₧gure+ only scans the list of modules for *con₧gure options when it
  80. is ₧rst started up, so if you load a module that has *con₧gure options, you
  81. will have to quit Con₧gure+ and re-run it to see them in the list.
  82. Conversely, if you quit a module that has *con₧gure options and then try to
  83. set the option with Con₧gure+, obviously Con₧gure+ will complain.
  84.  
  85. How to get this to work
  86. ***********************
  87.  
  88.    Con₧gure+ adds new features to !Con₧gure by adding four icons to
  89. Con₧gureæs main window, which means it has to modify Con₧gureæs Sprites,
  90. Templates and Messages ₧les. However, Con₧gure is ⌐ Acorn Computers Ltd., and
  91. the appropriate ₧les, especially when modi₧ed, cannot be distributed like
  92. freeware. As every Acorn user has a copy of Con₧gure, this isnæt too much of
  93. a problem: all you have to do is run a small öpatchò utility.
  94.  
  95.    You should have a program called öConfPatchò supplied with Con₧g+ (if not,
  96. complain loudly to the person who supplied you with Con₧g+). Running this,
  97. having öseenò Con₧g+, will create the appropriate ₧les, after asking you a
  98. few questions (see ConfPatchæs documentation for this).
  99.  
  100.    Before distributing Con₧gure+, run the Obey ₧le öDistributeò in the
  101. !ConfPatch directory (shift-double-click on the !ConfPatch icon to open it).
  102. This will delete the modi₧ed ₧les.
  103.  
  104. More about some new Con₧gure options
  105. ************************************
  106.  
  107.    Using interactive help should be enough to work out what the new Con₧gure
  108. options are, but in some cases there is slightly more to say than will ₧t in
  109. a help message.
  110.  
  111. Å More dithering in greyscale modes:
  112.    In a two or four-colour mode, the WIMP will use dithering to make up for
  113. the lack of colours; however, by default it will only do this for colours 0
  114. to 7, i.e. the grey scales. If you select this, it will use dithering for all
  115. the colours ù but this will not happen everywhere. In practice, sprites in
  116. Filer windows, on the Pinboard, the icon bar or application windows will not
  117. be dithered, except for Sprite editors and the like, for which this option
  118. has no effect as they dither anyway. Draw ₧les, Artworks ₧les and similar
  119. objects will also be dithered whatever the state of the option.
  120.    Essentially, dialogue boxes and similar windows will be dithered
  121. differently, as will menus. MemoryPie is a good example of the difference
  122. setting this option makes.
  123.    The current dither state will actually change on a mode change.
  124.    
  125. Å Smarter scrolling
  126.    This is a standard option, it even has its own *Con₧gure option, and there
  127. *is* a difference, but itæs not at all noticeable.
  128.  
  129. Replacing Con₧gure
  130. ******************
  131.  
  132.    To make the extension/replacement of Con₧gure complete, there are two ₧les
  133. in the !Con₧g+.Con₧gure directory, SetCon₧g and SetCon₧g+. Running SetCon₧g+
  134. will change Con₧gureæs icon to the Con₧g+ icon (i.e. add a small red ö+ò sign
  135. to it), and change the !Boot, !Run and !Help ₧les in !Con₧gure in the Apps
  136. directory to point to the ₧les in !Con₧g+, the upshot being that Con₧gure is
  137. replaced by Con₧g+. Run SetCon₧g to reverse these changes.
  138.  
  139.    As the RISC OS 3.50 version of !Con₧gure lives on the hard disc inside
  140. !Boot, and not in the Apps directory at all, SetCon₧g+ wonæt work all that
  141. correctly - I assume it will put the appropriate icon in the Apps directory,
  142. but if you double-click on !Boot (the recommended way to run Con₧gure,
  143. apparently) the old one will load.
  144.  
  145.    By default the !Con₧g+.!Boot ₧le runs SetCon₧g+; remove or comment out
  146. (pre₧x with a ö|ò) the offending line if you donæt want Con₧g+ to replace
  147. Con₧gure, or if you have a RISC PC. If you do want to make Con₧g+ the default
  148. version of Con₧gure, you might want to add a Filer_Boot
  149. Utilities:Extensions.!Con₧g+ (replace by the real path) to your Boot ₧le.
  150.  
  151.    The Conf+Resources module, the module that changes the ₧les in
  152. the Apps directory, was created by Joseph Walkeræs ResourceFS modi₧er,
  153. ResMod (with a Help string tweaked to make it look prettier in the *Help
  154. Modules list).
  155.  
  156. How it works
  157. ************
  158.  
  159.    This is mainly for the techies out there, but non-initiates may ₧nd it
  160. interesting.
  161.  
  162.    When you run Con₧g+, or run Con₧gure having run SetCon₧g+ previously, it
  163. does the following things:
  164.    Å Loads the module if it isnæt already loaded
  165.    Å Runs Con₧gure+ (which just sits in the background and waits for mouse
  166.      clicks)
  167.    Å Runs Con₧gure
  168.    Note that Con₧gure+ and Con₧gure have to be started up by separate ₧les,
  169. as you canæt run two programs from the same Obey ₧le, and Desktop ₧les donæt
  170. set the WimpSlot properly.
  171.  
  172.    The module sets up a ₧rst ₧lter on all tasks, intercepting all messages.
  173. When it gets a Message_TaskInitialise from either Con₧gure or Con₧gure+, it
  174. remembers their task handles; when it has a sensible value for both, it knows
  175. that both tasks have started up, so it sets up another ₧lter on Con₧gure,
  176. intercepting all mouse clicks, as well as open and close window events ù
  177. partly to know where the main window is, to align windows with the top, and
  178. also because the window handle of the main window changes every time itæs
  179. closed and re-opened. These are then passed along to Con₧gure+. When either
  180. of the tasks quits, a Message_TaskCloseDown is received by the ₧rst ₧lter, so
  181. the module stops the ₧lter on Con₧gure. Con₧gure+ is also checking for
  182. Message_TaskCloseDown, so if Con₧gure is quit Con₧gure+ will quit as well.
  183.    
  184.    In addition, the ₧rst ₧lter will also pass along DataLoad and DataOpen
  185. messages to Con₧gure+, so that when you double-click on a Con₧gure ₧le or
  186. drag it to the Con₧gure icon, Con₧gure+ loads all of it into CMOS rather than
  187. just the options Con₧gure knows about (which is what it usually does). This
  188. means all the con₧guration options are loaded, including things like
  189. ADFSBuffers and any third-party options. So you donæt have to use FlDesk
  190. anymore ;).
  191.  
  192.    Note that when Con₧gure+ gets a mouse click on one of Con₧gureæs windows,
  193. it has to know whether the window is the main window (in which case it should
  194. check if one of its icons has been clicked on), or another window (in which
  195. case it should ignore the mouse click). It canæt check the window title, as
  196. the title is stored in Con₧gureæs memory and therefore inaccessible, so it
  197. checks the number of icons in the window ù which should be 16 in the Main
  198. window. So whatever you do, donæt change the number of icons in the Main
  199. window!
  200.  
  201.    Oh, a cautionary tale: I spent what must be several hours (it certainly
  202. felt like it) trying to get the ₧lter to pass along DataLoad events to
  203. Con₧gure+. Sometimes it worked if I passed it along twice (but it only got
  204. there once); once, when it was being sent along three times, it arrived ₧ve
  205. times (according to Vigil, which I suspect was responsible for some of the
  206. crashes). The times I had to reboot the machine because the Filter Manager
  207. got confused... (shudder)
  208.  
  209.    The problem was that I was intercepting messages in the Con₧gure ₧lter
  210. (the second one), which seems like a logical thing to do, except that the
  211. ₧rst one was already intercepting messages for all tasks, including Con₧gure,
  212. and obviously the Filter Manager gets a bit confused when two ₧lters with the
  213. same name intercept the same events ;). So if you have more than one ₧lter
  214. intercepting events from potentially the same tasks, make sure theyære not
  215. intercepting the same ones...
  216.  
  217. Miscellanea
  218. ***********
  219.  
  220.    If you have loads of extra, non-Acorn, Con₧gure options, the Third Party
  221. window will cunningly sprout a scroll-bar.
  222.  
  223.    I have been told of a problem with the Ether3 module (obscure stuff, eh?),
  224. which apparently uses the same command to set all of its oodles of
  225. con₧guration options, which means you get a very long string in the Misc
  226. window that you canæt read. If itæs longer than 40 characters, it might crash
  227. the program.
  228.  
  229. Boring legal message
  230. ********************
  231.  
  232.    This application is freeware, that is, it can be distributed freely as
  233. long as only reasonable charges are made for media and distribution. I
  234. retain copyright on all program code and documentation.
  235.  
  236.    There is one exception to this, which is the modi₧ed Con₧gure ₧les in the
  237. !Config+.Configure directory ù namely, Templates, Messages, Sprites, and, if
  238. present, Sprites22 and Sprites23. If you have just got the program, and
  239. havenæt run !ConfPatch, you shouldnæt have these ₧les ù if you do, someone
  240. has been breaking the law. These ₧les remain ⌐ Acorn Computers Ltd., and so
  241. cannot be distributed along with the rest of the program ù you must run
  242. !ConfPatch to create them from the original ₧les. Before distributing Con₧g+,
  243. run the ₧le öDistributeò in the !ConfPatch directory to delete the modi₧ed
  244. ₧les. See also the section öHow to get this to workò for more details.
  245.  
  246.    This software is supplied öasáisò: I make no warranty, expressed or
  247. implied, of the merchantability of this software or its ₧tness for any
  248. particular purpose. In no circumstances shall I be liable for any damage,
  249. loss of pro₧ts, or any indirect or consequential loss arising out of the use
  250. of this software or inability to use this software, even if I have been
  251. advised of the possibility of such loss.
  252.  
  253.    In other words, if your computer crashes, blows up, you lose all your work
  254. etc. all because of Con₧gure+ (unlikely I know), donæt blame me.
  255.  
  256. About all these strange foreign characters in this ₧le
  257. *******************************************************
  258.  
  259.    OK, so if youære reading this on a PC or a Mac or another strange machine
  260. like that, you may be wondering what all these strange ae things are. Well,
  261. theyære quotes (sorry, there was another one), dashes, ligatures, etc.
  262. Honest. But not on all machines...
  263.    Basically, character sets are only standard up to character 127, which is
  264. basically alphanumerics and a few standard punctuation marks. Foreign
  265. characters, typographical oddities like quotes and ligatures, and other more
  266. obscure symbols are önon-standardò, and each computer often has its own idea
  267. of where they should go in the character set. So donæt worry: even if itæs
  268. hard to read on your current machine, it wonæt be on an Acorn machine. It may
  269. look slightly strange if youære using the System font, however.
  270.    But why am I using these strange characters in the ₧rst place? Well,
  271. theyære in the character set and they look nice in an outine font, and Iæve
  272. written a program called Smart Quotes (sorry for the plug) that substitutes
  273. these sort of characters automatically, and Iæve got it turned on at the
  274. moment...
  275.  
  276. Thanks
  277. ******
  278.  
  279.    Thanks are due to the following people (not in any particular order):
  280.       Dick Alstein for TemplEd (couldnæt live without it)
  281.       Cy Booker for his wonderful BASIC cruncher (registrationæs in the post)
  282.       Simon Middleton at Uniqueway for help and feedback
  283.       Rheingold for Vigil (I actually bought it)
  284.       David Rushall for FlDesk (I donæt actually use it normally, but the
  285.          compare CMOS option was useful)
  286.       Kemal Sangrar for his invaluable TaskGuard utility ù press Alt-Break
  287.          and the current task is aborted. Makes you wonder what all this
  288.          fuss over the RISC PC is all about ;).
  289.       Dominic Symes for Zap (couldnæt live without it)
  290.       Christopher Swaley for the ƒoppy disc con₧gure option
  291.       Dave Walker at Acorn Customer Support for all the help
  292.       Joseph Walker for ResMod
  293.       
  294.    Acorn get a ₧rm and hearty thumbs up for the machine, RISC OS, the Filter
  295. Manager in particular and the quality of the PRMs (and at ú100 I should think
  296. so ;) ), and a loud raspberry for not documenting all the CMOS options ù
  297. bytes 215 to 223 arenæt even mentioned, let alone described as öreserved for
  298. Acorn useò when they actually do something quite sensible, like other bytes
  299. I could think of. In the RISC OS 2 PRMs they already got the CMOS slightly
  300. wrong, so Acorn, if you know whatæs good for you ù sack the guy who does the
  301. CMOS ;).
  302.    Another thumbs up goes to Dave Walker at Customer Support for all the
  303. help, and another raspberry for those people who designed RISC OS 3.50
  304. Con₧gure, for not deleting the unused icons in the Templates ₧le (look at the
  305. original Templates and count the number of icons shifted to one side...).
  306.  
  307. How to contact me
  308. *****************
  309.  
  310. All bug-reports, suggestions, comments or indeed any feedback at all will be
  311. welcomed. Hereæs how to get to me:
  312.  
  313. E-mail     : 9262861k@arts.gla.ac.uk, 926286ki@udcf.gla.ac.uk during term-time
  314.              These should be OK until June 1996
  315.              At Christmas, Easter and during the summer, you can get me at
  316.              wombat@altern.com, wombat@email.teaser.com or sam@altern.com, in order
  317.              of preference (that is, if mail bounces off one of these or I donæt
  318.              answer within a week send to the next one).
  319.  
  320. Snail-mail : My term-time address, at least until June 1995, is:
  321.              Sam Kington
  322.              Flat 2/1
  323.              44 Hotspur Street
  324.              Glasgow G20 8NL
  325.              SCOTLAND
  326.              
  327.              Again, a backup is the home address ù anything that goes here will get
  328.              to me eventually.
  329.              Sam Kington
  330.              Merlhiot
  331.              24420 Savignac les Eglises
  332.              FRANCE
  333.  
  334. Term-time is October to June, with bits off at Christmas (3 weeks) and
  335. Easter (4 weeks).
  336.